home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / C and C++ / System / Finder Progress Bar / FinderProgressBar.doc < prev   
Encoding:
Text File  |  1993-08-29  |  3.0 KB  |  50 lines  |  [TEXT/KAHL]
  1. /*****************************************************************************************************
  2. *                                                                                                    *
  3. * FinderProgressBar.doc - Copyright 1993 Chris Larson (cklarson@engr.ucdavis.edu) All rights reserved*
  4. *                                                                                                    *
  5. * Documentation file of a CDEF which mimics the progress bar used in the Finder. This source file    *
  6. * and its compiled derivatives may be freely used within any freeware/shareware/postcardware/… as    *
  7. * long as you mention my name in your credits. Neither this source nor its compiled derivatives are  *
  8. * in the public domain and may not be use in any form in public domain software. Neither this source *
  9. * nor its compiled derivatives may be used in any form in a commercial product without the expressed,*
  10. * written consent of the author (me).                                                                *
  11. *                                                                                                    *
  12. * Version 1.0 -- Initial Release.                                                                    *
  13. *                                                                                                    *
  14. *****************************************************************************************************/
  15.  
  16. This CDEF implements a progress bar that mimics the one used by Finder. It should be extremely
  17. easy to use: simply set the control’s minimum and maximum to whatever values you wish, set the
  18. control value somewhere in-between (endpoints inclusive) and the CDEF will draw appropriately.
  19.  
  20. A couple of things to note:
  21.  
  22. 1)    This CDEF is currently limited in its function -- I wrote it for an application I’m
  23.     working on and didn’t worry about features I wouldn’t need (for example if you hilite it
  24.     with value 255 (supposed to dim a control) it looks the same: my app doeesn’t need to
  25.     dim any progress bars). If you find that extra functionality is a need, drop me a line
  26.     via e-mail and I’ll see what I can do.
  27.  
  28. 2)  This was intended as an EXACT copy (visually at least) of the progress bars used in the
  29.     Finder. As a result, the colors are hard-coded and no AuxCtlRec is ever examined. (This
  30.     really falls under (1) above but I thought it worth mentioning seperately.)
  31.  
  32. 3)    I haven’t had time to test this as extensively as I would have liked, (notably I haven’t
  33.     run it on a Mac without color quickdraw -- I believe the code to be correct but it remains
  34.     untested). As with added features, please send bug reports via e-mail.
  35.  
  36. 4)    If memory serves, the progress bars used by Finder are 11 pixels tall.
  37.  
  38. Legal Stuff:
  39.  
  40. You know the rules: I have tried to make this as error free as possible but by using it, you take
  41. full responsibility for anything that goes wrong.
  42.  
  43. Author:
  44.  
  45. Chris Larson
  46. 7009 Morton Court
  47. Stockton, Ca  95219
  48.  
  49. Internet E-Mail (Preferred) : cklarson@engr.ucdavis.edu
  50.